home *** CD-ROM | disk | FTP | other *** search
/ Freaks Macintosh Archive / Freaks Macintosh Archive.bin / Freaks Macintosh Archives / Internet / Telnet Clients / MacBlue Telnet / Doc / Readme < prev   
Encoding:
Text File  |  1995-02-15  |  10.0 KB  |  267 lines  |  [TEXT/ttxt]
  1. Warning, Warning, Warning
  2. =========================
  3.  
  4.   This is a modified version of NCSA Telnet, it has very ugly 
  5. (ugliest, from what I heard) user interface, it is so ugly that 
  6. you would probably not want to use your mac again. So if you 
  7. want the sticky (or stupid?) HIG, and prefer the old, pure B&W UI, 
  8. don't bother to get this thing.
  9.  
  10.   BTW, can someone tell me how to make a HanZi terminal that can
  11. show HanZi clearly without throw scroll bar out of window ?
  12. (a HanZi require 16x15 pixels, and 13" monitor is 640x480 
  13. pixels, a HanZi is a double-byte char. Do some calculation !)
  14.  
  15.  
  16. MacBlue Telnet 2.6.6
  17. ====================
  18.  
  19.     What's new on 2.6.6
  20.     -------------------
  21. + add Japanese(EUC-JIS) and Korean(EUC-KS) support
  22. + add input code lookup for HanZi (hold down [control] and click hanzi)
  23. + add beep preferences for terminal & HanZi input
  24. + [command][option] double-click URL specification to open URL session
  25.   (actually, it existed since 2.6.5, but I forgot to mention, and the
  26.    modifiers is [control] at 2.6.5)
  27. + [control] double-click terminal HanZi to lookup input code
  28. + various adjustment for HanZi input
  29. + many bug fix
  30.   + fix the Ftp server in PPC mode (from NCSA's)
  31.   + fix HanZi display with small size in 68K mode
  32.   + fix zoom size of key pad window
  33.   + fix mouse click with the linking-word function
  34.   + fix hanzi menu display
  35.   + fix crashing bug with preferences file
  36.   + fix crashing bug with long popup menu
  37.   + fix long menu scrolling
  38.   + fix crashing of NCSA Bridge in PPC mode
  39.   + what else ?
  40.  
  41.  
  42. TO-DO LIST
  43. ==========
  44.  
  45. + wanna faster scrolling ?
  46.  
  47.  
  48. FUNCTION SUMMARY
  49. ================
  50.  
  51.     Another "Manual" file (BIG5 encoded) give some info about 
  52. MacBlue Telnet, please read it as well. MacBlue Telnet is a modified 
  53. version of NCSA Telnet for Mac, the main objective is to support HanZi 
  54. properly, but it also has some other enhancements :
  55.  
  56.  + support 2-byte Hanzi code (display/type/copy/paste/select/etc...)
  57.  + support BUILT-IN HanZi Display
  58.  + support BUILT-IN HanZi Input
  59.  + support translation of major Chinese encoding (BIG5, GB, HZ, etc...)
  60.  + rewritten ftp client (finally it works)
  61.  + improved terminal handling (color, style, mouse support, etc...)
  62.  + performance enhancement
  63.  + drag & drop copy/paste service
  64.  + and a few others to enhance (and fix) the function of Telnet
  65.  
  66.  
  67. SYSTEM REQUIREMENT
  68. ==================
  69.  
  70.     MacBlue Telnet should work with 68020 or PowerPC Macintosh with 
  71. System 7.x or later. MacBlue Telnet is a Fat Bianry program. 
  72. 68000 machine (SE, Plus, etc...) and System 6.x users are no longer 
  73. supported.
  74.     
  75.     If you want to use built-in HanZi display & input methods, it is a 
  76. good idea to increase the memory partition, the default setting is fine
  77. to load both Chinese fonts.
  78.  
  79.     If you use built-in HanZi display, you need 13" screen to see full
  80. window, you can change the HanZi font size, but it will look ugly other
  81. than 12 point.
  82.  
  83.  
  84. HANZI ENVIRONMENT
  85. =================
  86.  
  87.     If you want to use built-in HanZi display, you must get the proper
  88. HanZi font. Two default HanZi fonts are available for Traditional Chinese
  89. (BIG5 encoded) and Simplified Chinese (GB encoded), and you can make your
  90. own with the "hzCov" program. Unfortunately the "hzCov" program 
  91. need some programming to use it, later version might have nice UI 
  92. (depend on public demand)
  93.  
  94.     Also you need to get some input table to use the built-in Input Method,
  95. a new utility called "hzBuild" allows you to use cxterm
  96. input method specification (the ".tit" file) to build input method. That
  97. means you can get a lot of input method immediately. In fact, the input
  98. method spec used by MacBlue Telnet is the superset of cxterm, you can
  99. use cxterm ".tit" file, but not vice versa. For that reason, you should
  100. rename modified ".tit" file to ".titmb".
  101.  
  102.     You should arrange files in this manner :
  103.  
  104.    "MacBlue Telnet" folder
  105.       |
  106.       +---- "MacBlue Telnet" application
  107.       |
  108.       +---- "NCSA Telnet Bridge" application (optional)
  109.       |
  110.       +---- "HanZi Font" folder (must spell exactly)
  111.       |        |
  112.       |        +---- "Simplified Chinese" font
  113.       |        |
  114.       |        +---- "Traditional Chinese" font
  115.       |        |
  116.       |        +---- etc...
  117.       | 
  118.       +---- "HanZi Input" folder (must spell exactly)
  119.                |
  120.                +---- "Chang-Jie" input method
  121.                |
  122.                +---- "Zu-Yin" input method
  123.                |
  124.                +---- etc...
  125.  
  126.    * You can use alias for "HanZi Font" && "HanZi Input" folder
  127.    * You must make sure MacBlue Telnet have enough memory allocated to load 
  128.      HanZi fonts, 1,600K partition is fine to load both fonts.
  129.    * Input methods also use more memory, but they are load on demand, you
  130.      only need to increase memory partition by the largest input 
  131.      method size.
  132.  
  133.  
  134. POWERMAC USER NOTE
  135. ==================
  136.  
  137.    PowerMac user need "Macintosh Drag & Drop" 1.1 or later to run this 
  138. program, a single "Macintosh Drag & Drop" extension is included in this
  139. release. You can ftp the complete "Macintosh Drag & Drop" package from
  140. ftp.apple.com, which include Finder 7.1.3 as well as Cliping extension.
  141. "Macintosh Drag & Drop" is now a standard part of System 7.5.
  142.     
  143.  
  144. LIVE WITH alt.chinese.text
  145. ==========================
  146.  
  147.     If you plan to use MacBlue Telnet to read alt.chinese.text or 
  148. other HZ encoded source. You should have CLK or HanZi font installed.
  149. Then you just need to select [HanZi Display Filter][HZ -> GB], and that's it.
  150. ( You must select the right font anyway)
  151.  
  152.     If you need to input HZ codes, remember to type ~{ before HZ and ~} after,
  153. this is how the HZ works. If you need to type 8-bit clean HanZi (the native
  154. HanZi), remember to type "stty pass8" or "stty -istrip cs8", that will tell
  155. your host to accept 8-bit codes.
  156.  
  157.  
  158. SOME SHORTCUT
  159. =============
  160.  
  161.     Here are some shortcut that is not documented anywhere :
  162.  
  163.   DRAG & DROP COPY/PASTE
  164.   ----------------------
  165.   + drag & drop works in BBS Editor mode, in this mode, the text
  166.     is moved (insteaded of being copyed) in the same window
  167.   + if you are in BBS Editor mode, and want to copy (instead of moving),
  168.     hold down [shift] will force text copy
  169.   + if you are in BBS Editor mode, drag selection to trash can will
  170.     delete that selection
  171.   + when you drag & drop, the default copy method is normal [COPY]
  172.     and default paste method is normal [PASTE]. Hold down [control]
  173.     and drag & drop will use [COPY TABLE] & [PASTE WRAP]
  174.  
  175.   WINDOW HANDLING
  176.   ---------------
  177.   + [command]-drag window will not bring window up to front, you can also
  178.     move window behind dialog box with [command]-drag
  179.   + [option]-click window title will zoom in/out window
  180.   + [command]-[option]-click window title or [option]-click zoom box will
  181.     zoom window to screen size
  182.   + hold down [option] when growing the window will automatically change
  183.     real terminal size
  184.  
  185.   TERMINAL WINDOW
  186.   ---------------
  187.   + you can scroll the window by holding down [command] key and click wthin
  188.     terminal window, click at upper part will scroll up, and bottom will
  189.     scroll down.
  190.   + hold down [command]-[shift] will scroll pages instead of lines
  191.   + hold down [option] key will temporarily toggle mouse cursor
  192.   + hold down [command]-[option] you can double-click a URL spec in 
  193.     terminal window to open it, telnet and ftp session are supported
  194.   + hold down [control] and double-click HanZi in terminal window,
  195.     you are able to lookup input code for that HanZi
  196.  
  197.   HANZI ENVIRONMENT
  198.   -----------------
  199.   + hit [option]-space to switch English and HanZi input
  200.   + hit [option][shift]-space to switch full-size ASCII and HanZi input
  201.   + hit [shift]-space to switch full-size mode within HanZi input
  202.   + hit [tab] when you use Input Method will let you input punctuation
  203.     temporally, hit [control]-[tab] will send [tab] char
  204.   + hit [control]-digit allow you to select associated pharse even the
  205.     digit has been assigned to input codes (such as in ZuYin case)
  206.   + hold down [option] and click the zoom box of input window will
  207.     put the window back to normal position
  208.   + you can arrange the order of input method in menu by rename the input
  209.     table file in "HanZi Input" folder, the "By Name" order is the load
  210.     order
  211.   + if the first two chars of the name of input table file is "!#",
  212.     it will be assigned to punctation input (with hot key [option]-dot)
  213.   + if the first two chars of the name of input table file is "!*",
  214.     it will be assigned to full-size (the ASCII char in HanZi code, and
  215.     with hot key [shift][option]-space)
  216.   + if the last second char of the name of input table file is "%",
  217.     it will be assigned to the hot key following (eg. "%1" will
  218.     be [option]-1)
  219.   + hold down [control] and click HanZi in the choice list or code pad
  220.     window, you can look up the input code for it
  221.  
  222.  
  223. DISTRIBUTION
  224. ============
  225.  
  226.   You can get the new version from
  227.  
  228.   ftp://imftp.mgt.ncu.edu.tw/pub/contrib/MacBlueTelnet/
  229.   ftp://physgi.phy.ncku.edu.tw/pub/network/MacBlueTelnet/
  230.   ftp://ftp.ifcss.org/software/mac/networking/MacBlueTelnet/
  231.   ftp://nctuccca.edu.tw/chinese/ifcss/software/mac/networking/MacBlueTelnet/
  232.  
  233.    Readme
  234.    --  the readme file
  235.  
  236.    MacBlueTelnet.sea.hqx
  237.    --  the main programs and two Chinese HanZi font
  238.    
  239.    AsciiBitmap.sea.hqx
  240.    --  you can replace the ascii bitmap in the HanZi font now
  241.  
  242.    Telnet.plugin.sea.hqx
  243.    --  the plug-in module to enable Encryption/Authentication,
  244.        please put them into "Extension" Folder or the application folder
  245.  
  246.    langTradChinese.sea.hqx
  247.    langSimpChinese.sea.hqx
  248.    langJapanese.sea.hqx
  249.    langKorean.sea.hqx
  250.    --  the Input methods and font for each language,
  251.        Chinese fonts are not included (they are in MacBlueTelnet.sea.hqx)
  252.  
  253.    source/MacBlueTelnet.src.sit.hqx
  254.    --  the source code & HZCov utility,
  255.        require CodeWarrior DR5 or later to compile
  256.  
  257.    source/langTradChinese.src.sit.hqx
  258.    source/langSimpChinese.src.sit.hqx
  259.    source/langJapanese.src.sit.hqx
  260.    source/langKorean.src.sit.hqx
  261.    --  the source for input methods
  262.  
  263.   FTP Server adm. NOTE:
  264.    Please trash other old files to avoid confusion, and keep
  265.    files in the same hierarchy if possible. You can make symbolic links
  266.    to the files if you want them to appear in other directory.
  267.